home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / drv_usectohz.z / drv_usectohz
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ddddrrrrvvvv____uuuusssseeeeccccttttoooohhhhzzzz((((DDDD3333))))                                              ddddrrrrvvvv____uuuusssseeeeccccttttoooohhhhzzzz((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _dddd_rrrr_vvvv______uuuu_ssss_eeee_cccc_tttt_oooo_hhhh_zzzz - convert microseconds to clock ticks
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _cccc_llll_oooo_cccc_kkkk______tttt _dddd_rrrr_vvvv______uuuu_ssss_eeee_cccc_tttt_oooo_hhhh_zzzz_((((_cccc_llll_oooo_cccc_kkkk______tttt _m_i_c_r_o_s_e_c_s_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _m_i_c_r_o_s_e_c_s The number of microseconds to convert to equivalent clock
  18.                ticks.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _dddd_rrrr_vvvv______uuuu_ssss_eeee_cccc_tttt_oooo_hhhh_zzzz converts the length of time expressed by _m_i_c_r_o_s_e_c_s, which is
  22.      in units of microseconds, into units of clock ticks.
  23.  
  24.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  25.      The value returned is the smallest number of clock ticks that represent a
  26.      time interval equal to or greater than the _m_i_c_r_o_s_e_c_s argument.  No error
  27.      value is returned.  If the number of ticks equivalent to the _m_i_c_r_o_s_e_c_s
  28.      argument is too large to be represented as a _cccc_llll_oooo_cccc_kkkk______tttt, then the maximum
  29.      _cccc_llll_oooo_cccc_kkkk______tttt value will be returned.
  30.  
  31. UUUUSSSSAAAAGGGGEEEE
  32.      Several functions either take time values expressed in clock ticks as
  33.      arguments [_iiii_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt(D3), _dddd_eeee_llll_aaaa_yyyy(D3)] or return time values expressed in
  34.      clock ticks [_dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm(D3)].  The length of a clock tick can vary
  35.      across different implementations, and therefore drivers should not
  36.      include any hard-coded assumptions about the length of a tick.
  37.      _dddd_rrrr_vvvv______uuuu_ssss_eeee_cccc_tttt_oooo_hhhh_zzzz and the complementary function _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc(D3) can be used,
  38.      as necessary, to convert between microseconds and clock ticks.
  39.  
  40.    LLLLeeeevvvveeeellll
  41.      Initialization, Base or Interrupt.
  42.  
  43.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  44.      Does not sleep.
  45.  
  46.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  47.      across calls to this function.
  48.  
  49. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  50.      _dddd_eeee_llll_aaaa_yyyy(D3), _dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm(D3), _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc(D3), _iiii_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt(D3)
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.